PATHMac OS 8 and 9 Developer Documentation > Human Interface Toolbox > Menu Manager >

Mac OS 8.5 Menu Manager Reference

DisableMenuItemIcon

Disables the icon associated with a menu item.

pascal void DisableMenuItemIcon (
                     MenuHandle theMenu,
                     UInt16 item);
theMenu
A value of type MenuHandle . Pass a handle to the menu containing the icon to be disabled.
item
An unsigned 16-bit integer. Pass a value specifying the item number of the menu item containing the icon.

DISCUSSION

Your application can use the DisableMenuItemIcon function to dim individual menu item icons. The menu item that contains the icon is unaffected by calling DisableMenuItemIcon . That is, if DisableMenuItemIcon disables an enabled menu item's icon, the menu item itself will remain enabled. Calling DisableMenuItemIcon on the icon of a menu item that is currently disabled will cause the icon to be disabled once the menu item is re-enabled.


VERSION NOTES

Available with Mac OS 8.5 and later.


SEE ALSO

The function EnableMenuItemIcon .

The function IsMenuItemIconEnabled .

© 1999 Apple Computer, Inc. — (Last Updated 19 Jan 99)